home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_bind.idb / usr / freeware / catman / u_man / cat5 / irs.conf.5.z / irs.conf.5
Text File  |  1998-05-26  |  5KB  |  117 lines
  1. IRS.CONF(5)                 BSD Programmer's Manual                IRS.CONF(5)
  2.  
  3. NNAAMMEE
  4.      iirrss..ccoonnff - Information Retrieval System configuration file
  5.  
  6. SSYYNNOOPPSSIISS
  7.      iirrss..ccoonnff
  8.  
  9. DDEESSCCRRIIPPTTIIOONN
  10.      The irs(3) functions are a set of routines in the C library which provide
  11.      access to various system maps.  The maps that irs currently controls are
  12.      the following: passwd, group, services, protocols, hosts, networks and
  13.      netgroup.  When a program first calls a function that accesses one of
  14.      these maps, the irs configuration file is read, and the source of each
  15.      map is determined for the life of the process.
  16.  
  17.      If this file does not exist, the irs routines default to using local
  18.      sources for all information, with the exception of the host and networks
  19.      maps, which use the Domain Name System (DNS).
  20.  
  21.      Each record in the file consists of one line.  A record consists of a
  22.      map-name, an access-method and possibly a (comma delimited) set of op-
  23.      tions, separated by tabs or spaces.  Blank lines, and text between a #
  24.      and a newline are ignored.
  25.  
  26.      Available maps:
  27.  
  28.            Map name        Information in map
  29.            =========       ==================================
  30.            passwd          User authentication information
  31.            group           User group membership information
  32.            services        Network services directory
  33.            protocols       Network protocols directory
  34.            hosts           Network hosts directory
  35.            networks        Network "network names" directory
  36.            netgroup        Network "host groups" directory
  37.  
  38.      Available access methods:
  39.  
  40.            Access method   Description
  41.            =============   =================================================
  42.            local           Use a local file, usually in /etc
  43.            dns             Use the domain name service (includes hesiod)
  44.            nis             Use the Sun-compatible Network Information Service
  45.  
  46.      Available options:
  47.  
  48.            Option          Description
  49.            ========        ================================================
  50.            continue        don't stop searching if you can't find something
  51.            merge           don't stop searching if you CAN find something
  52.  
  53.      The continue option creates ``union namespaces'' whereby subsequent ac-
  54.      cess methods of the same map type can be tried if a name cannot be found
  55.      using earlier access methods.  This can be quite confusing in the case of
  56.      host names, since the name to address and address to name mappings can be
  57.      visibly asymmetric even though the data used by any given access method
  58.      is entirely consistent.  This behavior is, therefore, not the default.
  59.  
  60.      The merge option only affects lookups in the groups map.  If set, subse-
  61.      quent access methods will be tried in order to cause local users to ap-
  62.      pear in NIS (or other remote) groups in addition to the local groups.
  63.  
  64. EEXXAAMMPPLLEE
  65.            # Get password entries from local file, or failing that, NIS
  66.            passwd          local   continue
  67.            passwd          nis
  68.  
  69.            # Build group membership from both local file, and NIS.
  70.            group           local   continue,merge
  71.            group           nis
  72.  
  73.            # Services comes from just the local file.
  74.            services        local
  75.  
  76.            protocols       local
  77.  
  78.            # Hosts comes first from DNS, failing that, the local file
  79.            hosts           dns     continue
  80.            hosts           local
  81.  
  82.            networks        local
  83.  
  84.            netgroup        local
  85.  
  86. NNOOTTEESS
  87.      If a local user needs to be in the local host's ``wheel'' group but not
  88.      in every host's ``wheel'' group, put them in the local host's _/_e_t_c_/_g_r_o_u_p
  89.      ``wheel'' entry and set up the ``groups'' portion of your _/_e_t_c_/_i_r_s_._c_o_n_f
  90.      file as:
  91.  
  92.            group   local   continue,merge
  93.            group   nis
  94.  
  95.      NIS takes a long time to time out.  Especially for hosts if you use the
  96.      --dd option to your server's ``ypserv'' daemon.
  97.  
  98.      It is important that the _i_r_s_._c_o_n_f file contain an entry for each map.  If
  99.      a map is not mentioned in the _i_r_s_._c_o_n_f file, all queries to that map will
  100.      fail.
  101.  
  102.      The classic NIS mechanism for specifying union namespaces is to add an
  103.      entry to a local map file whose name is ``+''.  In IRS, this is done via
  104.      ``continue'' and/or ``merge'' map options.  While this results in a small
  105.      incompatibility when local map files are imported from non-IRS systems to
  106.      IRS systems, there are compensating advantages in security and configura-
  107.      bility.
  108.  
  109. FFIILLEESS
  110.      /etc/irs.conf      The file iirrss..ccoonnff resides in _/_e_t_c.
  111.  
  112. SSEEEE AALLSSOO
  113.      groups(5),  hosts(5),  netgroup(5),  networks(5),  passwd(5),
  114.      protocols(5),  services(5)
  115.  
  116.  BIND                          November 16, 1997                             2
  117.